/*
 * Copyright (c) 2024 endless-sky
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef EL_PROTOCOL_GENERIC_CONFIG_COMMAND_HANDLER_H
#define EL_PROTOCOL_GENERIC_CONFIG_COMMAND_HANDLER_H

#include <string>
#include <unordered_map>
#include <nlohmann/json.hpp>
#include <functional>
#include "command_handler_base.h"

namespace El {
namespace Protocol {

/**
 * @brief 通用配置命令处理器
 * 处理通用的配置获取和设置请求，支持任意配置名称
 */
class ConfigCommandHandler : public CommandHandlerBase {
public:
    /**
     * @brief 构造函数
     * 注册所有支持的命令处理函数
     */
    ConfigCommandHandler();

    /**
     * @brief 析构函数
     */
    virtual ~ConfigCommandHandler() = default;

    /**
     * @brief 获取命令处理器映射
     * @return 命令处理器映射表
     */
    std::unordered_map<std::string, std::function<nlohmann::json(const std::string &, const nlohmann::json &)>> &
    GetHandlers()
    {
        return handlers;
    }

    /**
     * @brief 注册方法处理器到全局映射表
     * @param globalHandlers 全局处理器映射表
     */
    void RegisterMethodHandlers(
        std::unordered_map<std::string, std::function<nlohmann::json(const std::string &, const nlohmann::json &)>>
            &globalHandlers);

private:
    /**
     * @brief 处理通用配置获取请求
     * @param id 请求ID
     * @param params 请求参数，包含name字段指定配置名称
     * @return JSON响应
     */
    nlohmann::json HandleGetConfig(const std::string &id, const nlohmann::json &params);

    /**
     * @brief 处理通用配置设置请求
     * @param id 请求ID
     * @param params 请求参数，包含name和config字段
     * @return JSON响应
     */
    nlohmann::json HandleSetConfig(const std::string &id, const nlohmann::json &params);

    /**
     * @brief 验证配置名称的有效性
     * @param name 配置名称
     * @return bool true=有效，false=无效
     */
    bool ValidateConfigPath(const std::string &name);

    /**
     * @brief 标准化配置名称格式
     * @param name 原始配置名称
     * @return 标准化后的配置名称
     */
    std::string NormalizeConfigPath(const std::string &name);

    /**
     * @brief 校验算法管理配置，限制启用算法数量
     * @param config 算法管理配置内容
     * @param errorMessage 校验失败时的错误信息
     * @return bool true=校验通过，false=校验失败
     */
    bool ValidateAlgoManagerConfig(const nlohmann::json &config, std::string &errorMessage);

private:
    // 命令处理器映射表
    std::unordered_map<std::string, std::function<nlohmann::json(const std::string &, const nlohmann::json &)>>
        handlers;
};

} // namespace Protocol
} // namespace El

#endif // EL_PROTOCOL_GENERIC_CONFIG_COMMAND_HANDLER_H
